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SOPHWARE DISKS 


Sophware is establishing a collection of 
disks containing utilities and other 
software in use in the department from 
which users may make their own copies of 
the programs they need. Two disks (four 
sides) are now available. 


SOPHWARE DISK @1A: Directory utilities, 
various disk set-up and maintenance 
utilities, file display utilities, a disk 
register and some batch processing 
utilities. 


SOPHWARE DISK @1B: Disk catalog systems, 
disk salvage (from bad sector) utilities, 
disk access (track and sector) utilities, 
and others. 


SOPHWARE DISK 2A: Perfect Writer 
salvage utilities (recover data from the 
SWP file and from FIN files), programs for 
sending files to the printer, programs for 
modifying files (e.g., by removing TABs), 
and others. 


SOPHWARE DISK 2B: 
Perfect Writer 
patched version 
producing a_ solid 


A patched version of 
allowing disk reset, a 
of Perfect Formatter 
rather than dashed line 
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disk conversion 
programs for 


to mark off notes, some 
programs and configuration 
CP/M and for PF.DAT. 


The disks are available for copying from 
Maxine. Each disk has a file called 
/READ.ME containing further information 
about the programs. [RWB 1985 8 29] 


COLLECTING UTILITIES 


Utilities are handy little programs that 


within the 
usually what 
use outside that 
WASH+ is an example. 


perform useful little tasks 
computer environment though 

they do would have no 
environment. 


utilities 
Most of 
programs, invented 


There are a great many 
available in the CP/M environment. 
them are public domain 
by hobbiests and freely offered to the 
computer world through computer clubs. 
(One may add these benefactors of humanity 
to the list of refutations of psychological 
egoism. ) 


A utility often goes through a series of 
versions as the original author, or others, 
attempt to improve it. This leads to the 
practice of having two names for a utility 
—- an archival name which includes its 
version number and a working name which 
doesn't, and which may in fact be anything 
the user finds convenient. For example, 
the program we know as WASH+ is actually 
version 7.6 of a program properly named 
DISK. When you acquire a utility you 
usually store away a copy under the 
archival name, and then make working copies 
with whatever name you please, often the 
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archival name minus the version number. 
(Of course, the type will always have to be 
.COM or it won't run.) 


All of this is important because we have 
a large number of utilities in the 
department, and they are available for 
copying by our users. They will be placed 
on disks labelled SOPHWARE, and will be 
available from Maxine. SOPHWARE DISKs 1 and 
2 are now ready, and are described 
elsewhere in this issue. 


A utility doesn't do you much good 
unless you know how to run it. For that 
reason utilities are usually accompanied by 
a text file containing instructions. You 
read this file by displaying it on the 


screen or printing out a hard copy. This 
is known as the documentation file, and 
usually has the same name as the utility 
with the type .DOC. So one would look for 
such a pair as DISK76.COM and DISK76.DOC. 
You usually store away a copy of the DOC 
file along with your archive copy. [RWB 
1985 8 9] 


SETTING UP YOUR DISKS 


Most of us most of the time when at the 
computer are using Perfect Writer. There 
are PW-Edit disks containing that program 
lying around in the vicinity of each 
computer, and one can get by using one of 
those, but it is a lot better to have your 
own program disk. The advantages are first 
that you will know what is on it since no 


one else will be using and _ possibly 
changing it, and you will always be using 
the same disk. Second, you can modify the 
disk in various ways to suit your own 


preferences and needs. 


In addition to a PW-Edit 
want one (or more) disks of utilities and 
system programs. And you might as well 
have your own The Word Plus’ spelling 
checker disk. In fact, as a general rule, 


disk you will 
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you will only want to use the common disks 
as sources from which to make your own 
personal disks. 


On top of that, you will want to have 
backups of everything you have. And 
backups to the _ backups, and so on, 
depending on your averseness to risk. 


And in any event you will need your own 
data disks on which to put your files. 


a disk for use is a rather 
computer skill; this article 


So, preparing 
fundamental 
tells how. 


There are lots of different ways to set 
up a disk, but they all involve three basic 
operations. First the disk must be 
formatted; this involves filling all the 
tracks on the disk with dummy data, in fact 
the number 229 repeated over and over 
again. There are forty tracks on our 
Kaypro disks, numbered @ through 39, and 
they all must be filled. (229 is E5 in 
hexidecimal notation and 111911 in binary; 
I have been told sound reasons why this is 
a good number to use for this purpose, but 
have never understood them.) 


Second, the operating system, 
an empty directory, must be 
tracks @ and 


including 

placed on 
1, which are the outside 
tracks, and are called ‘reserved tracks'. 
(Strictly, this does not have to be done 
with a data disk, but if the system isn't 
there then the disk will not boot from the 
A: drive.) 


Finally, the desired files must be 
copied onto the disk. As this is done, a 
directory is automatically set up and 
maintained starting at the beginning of 
track 1, where the name of the file is 
stored along with information indicating 
where on the disk the file itself has been 
placed. 


The crude way to do these things is with 
three separate programs; FORMAT = for 
formatting, SYSGEN (System generator) for 
putting the operating system on its track, 
and PIP (or RPIP) for copying files. But 
there are easier ways. 


The program COPY will format a disk, 
copy the operating system from a_ source 
disk to it and, if you want, also copy all 
the files from the source disk. It will do 


“4 
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other things, too.) This runs on straight 


“am, CP/M as well as on ZCPR. If you are using 


the PluPerfect enhanced version of CP/M you 
have a- program FASTCOPY which’ does 
essentially the same things. 


To use COPY you put a disk containing it 
in the A: drive, presumably your utility 
disk, and a new disk (or an old one being 
redone) in drive B:. You log onto A: and 
type COPY. This gives you a menu which 
should guide you the rest of the way. 


Since I seldom want simply to duplicate 
a disk I generally use COPY to format and 
sysgen and then use RPIP or WASH+:or SWEEP 
to copy the particular files I want. WASH+ 
and SWEEP are easiest; RPIP is powerful but 
less than self-evident and you will have to 
hunt up instructions in a CP/M manual - or 
perhaps some issue of Sophware., 


On your Edit disk you will need 


PW.COM 35k 
PW.SWP 65k 
PF.COM 35k 
PF.DAT 5k 
PP .COM 23k 


I generally add XTRAKEY, some associated 
key definition files and SAVEKEY, which 


gives another 1lk for a total of 174k. That 
leaves 17k for 
will want to have handy. 


whatever utilities I feel I 
[RWB 1985 8 7] 
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A PAT 
The July-August, 1985 issue 
the newsletter of the 
contains on p. 3 a 
Perfect Writer. This is a modification 
which allows you to reset the drives from 
within ~ Perfect Writer. The command 
<CONTROL>-X S, which is meant to summon the 
spelling checker Perfect Speller, and which 


we never use, is changed so that it 
commands the computer to reset both drives, 


= ( FS] 
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of Kugram, 
Kaypro User's Group, 
useful patch for 
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that is, make it possible to write to both 
disks. 


I have done this to version 1.20 of PW, 
and it seems to work. I also changed the 
mode line so that it informs the user of 
this patch. There is a copy of the 
modified program on SOPHWARE DISK $2B under 
the name PWRESET.COM. (Those using the 
PluPerfect enhanced version won't want this 
because that version already includes a 
reset command, ) 


This patch enables you to change data 
disks without leaving Perfect Writer. (You 
wouldn't dare to do that ordinarily because 
you wouldn't be able to save your file.) 
This is a lifesaver if you have carelessly 
let your file grow too large for available 
disk space. It is also a handy way to make 
a backup copy of the file you are working 
on. Just remember to reset the drives 

and before attempting 
[RWB 1985 8 16] 


after changing disks 
to save your file. 


I've always found the operation of the 
TAB key a_ bit confusing on the computer, 
but I think I've got the hang of it now. 


The crucial thing to grasp is that the 
TAB is its own special character, and that 
when you type a TAB into Perfect Writer, 
it's the TAB character that goes into your 
file. (In the ASCII code, which is what 
our Kaypros use, the TAB character is 
represented by number 9. That is the same 
number you give the computer when you hit 
<CONTROL>-I, which you can use if you like 
instead of the TAB key.) 


That is simple enough. The tricky part 
is that programs do special things when 
they see a TAB character, and different 
programs do different special things. 


TABs on the screen: 
What Perfect Writer does when it sees a 


TAB is display the next character in the 
next tab column. The default for Perfect 
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Writer is to have the tab columns occur 
every eight characters, that is, when the 
left most column is 1, then the tab columns 
are 9, 17, 25, etc. This can be changed by 
the command 


<ESCAPE> n <CONTROL>-X <TAB> 


where n is the TAB number you want. You 
can also change the number by placing the 
cursor in what you wish to be the first TAB 
column, and then entering 


<CONTROL>-X <TAB> 


The new number, which will be operative 
until you change it again or leave Perfect 
Writer, now takes over and controls cursor 
movements for all the TAB characters in 
your file, even the ones you entered before 
the change, which can sometimes be a bit 
startling. 


TABs on paper: 

It must be remembered that for Perfect 
Writer the TAB character is simply an 
instruction about how your file is to be 
displayed on the screen, and has nothing to 
do with how your file will be printed. That 
is up to Perfect Formatter. 


- What Perfect Formatter does with a TAB 
depends on the environment. If you are in 
an ordinary environment then Perfect 


Formatter treats the TAB just as it treats 
a space, and tries to shape a paragraph. 

But if your are in VERBATIM then where your 
MSS file has a TAB character your FIN file 
will have three bytes of code that 
(somehow) tell the printer how far to move 
the print head to get to the next TAB 
column, where the next character will be 
printed. How far this is depends on what 
Perfect Formatter believes the TAB number 
to be, 


which may or may not be the same 
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number you were using in Perfect Writer; if 
it isn't then the results will probably not 
be what you expected. 


Perfect Formatter's TAB number is 
contained in the STYLE section of the file 
PF.DAT. It is ordinarily set at 8, but you 


can change it (on your own personal copy, 
of course) using the configuration program 
PFCONFIG, about which more on some other 
occasion. 


What to do: 

The upshot is that if you want to get 
predictable results with TAB you have to 
use VERBATIM and you have to be sure that 
Perfect Writer and Perfect Formatter agree 
on the same TAB number. 


Or you can resort to an 
bypass Perfect Formatter's TAB handling 
procedures by replacing all TAB characters 
in your MSS file by the appropriate number 
of spaces before sending the file to 
Perfect Formatter, This would be tedious to 
do by hand, but there is a utility, DETAB, 
(written by me, as it happens), which will 
do this for you. You give it the name of 
the file and the TAB number you want and it 
takes over from there. There is a copy on 
SOPHWARE DISK 1. 


evasion; you can 


The same thing can be done with the [T?] 
option on PIP (or RPIP). The command to the 
B> prompt: 


RPIP B:SPACED.MSS = B: TABBED.MSS[T5] 


will result in the file TABBED.MSS being 
copied to SPACED.MSS but with the TABs 
replaced by enough spaces to to make every 
fifth column a TAB column. 


You still need to use VERBATIM, of 
course, even if you replace TABS by spaces 
or your extra spaces will be formatted away 
by Perfect Formatter, but with this method 
you can use an. unusual TAB number in 
Perfect Writer without the need to -change 
the TAB number in PF.DAT. 


Further notes: 


You usually use TABs when setting up 
columns of figures, or the like, and for 
that purpose it is often helpful to switch 
Perfect Writer modes. Use NORMAL instead 
of FILL, and perhaps OVERWRITE as well. 
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Also, in playing around with TABs you 
should remember that the Perfect Writer 
commands <ESCAPE> S (Display a line in the 
center) and <ESCAPE> J (move the cursor to 
the next line just under the first 
character of the present line) work by 


inserting TAB characters instead of spaces 
[RWB 1985 8 11] 


-where possible. 
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FLUSH LEFT AND 


The commands 


Sn, 


RIGHT 


@STYLE( JUSTIFICATION yes, 
INDENTATION 9 mm) 


@W<Left side> @W<Right side> 
@wW< > 
@STYLE( INDENTATION 512 micas) 


produce the following result: 


Left side Right side 
This is a way of getting the effect of 
both FLUSHLEFT and FLUSHRIGHT on a_ single 
line, which is a thing you want to do 
occasionally, for example, in doing a 
course outline. 
Setting the INDENTATION to @ gets’ the 


FLUSHLEFT by starting a paragraph with 9 
indent. Putting the two chunks in the @W<> 
structure causes justification to produce 
the FLUSHRIGHT effect. The long ‘'‘word' 
made up of spaces is to persuade the 
justification procedure that the previous 
line is not the last line of a paragraph: 
it has to be long enough to prevent the 
FILL procedure from moving it up. Then the 
INDENTATION is reset to 512 micas, the 
normal setting. 


It appears that there has to be a blank 
line after you set the INDENTATION before 
the new setting takes effect. [ RWB 
1985 8 25] 
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SUPER DIRECTORY 


SD, or Super Directory, is 
directory utility, and version 9.1, which 
takes 4k and is the latest I know of, has a 
number of special features beyond simply 
showing you your files and their sizes. 
Those using earlier versions might consider 
upgrading. It is available on SOPHWARE 
DISK @1A. 


an excellent 


You use it by typing a command to the 
CP/M prompt, which you end, of course, with 
a carriage return. You do this instead of 
the command DIR, which is built into CP/M, 
is always available, but which is less 
informative. 


In its basic use, you type 
SD 


and it shows you the directory of the 
logged disk in alphabetical order. You can 
look at the directory of the other disk by 
adding the drive name: 


SD A: 


will show you the directory of A: even if 
you are logged onto B:. And you can use 
CP/M wild cards to look at just part of the 
directory; for example, 


SD A:*.MSS 
will show you just the MSS files on drive 
Ass 
Most directory programs do these things, 
but with this version of SD you can add 


some useful supplementary commands. After 
the basic command and before the <CR> you 
type a <SPACE>, then a '$', and then a 
string of letters and/or numbers to give 
the desired command, as follows: 


F Makes a text file of the 
directory on the logged disk 
under the name SD.DIR.If there 
already is a file with that 
name, the new directory is 
appended to it. This is useful 
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because you can subsequently 
summon that file from within 
Perfect Writer if you forget 
what files you had on the disk. 


P Sends the directory to the 
printer. 
N Gives you continuous display or 


printing instead of paging 
screenful by screenful. 


L Adds the directories of any 
library (LBR) files on the 
disk. (It is possible, with 
utilities such as LU or NULU, to 
bundle together a number of 
separate files into a single big 
file with the type LBR, with 
some saving of disk space and a 
simplification of the 
directory. More on that on 
another occasion.) 


R Reset the drives. 


V Display the version number (to 
make sure you have 9.1). 


4 2 column format (4% character 
screen). 

6 3 column format (69% character 
screen). 

8 4 column format (80 character 


screen, the default). 


C Is said to clear the screen 
before displaying the directory, 
but it doesn't seem to work, at 
least on my Kaypro. 


D If you are on A: this will give 
you directories for both A: and 
Be. 
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Thus, if you are on B: the command 
SD $FP6 


will show you the directory for Bin 3 
column format, print it and make a file of 
it. 


There are some further options, S, U and 
A, having to do with system files and user 
areas, but they seem to be of little use to 
us. They are described in the DOC file. 
[RWB 1985 8 24] 
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THE PW MENU: MORE 


The discussion of dropping the PW Menu in 
Sophware, Nel, missed one of the 
supplements to the Perfect Printer command, 
PP, It is 


-Non 
where n is the number of copies you want 
printed. This is seldom used since it is 
easier to do copies with the photocopier. 


[RWB 1985 8 14] 
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